home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 024a / tc903.zip / TC903.DOC < prev    next >
Text File  |  1991-05-21  |  49KB  |  896 lines

  1.  
  2.                               TurboCALC(tm) v9.03
  3.  
  4.                  Copyright (c) 1985, 1991: by P&M Software Co.
  5.                  TurboCALC is the trademark of P&M Software Co.
  6.  
  7.        TurboCALC is "User Supported" software.  If you like the program,
  8.        use it, and want to see it supported and improved in the future, a
  9.        contribution of $30 would be appreciated.  Please copy and share
  10.        this program with your friends, even if you are unable to make a
  11.        contribution.
  12.  
  13.  
  14.                               Send Contributions to:
  15.  
  16.                               P&M Software Co.
  17.                               3104 E. Camelback #503
  18.                               Phoenix, AZ 85016
  19.  
  20.  
  21.        For further information concerning the TC registration plan, please
  22.        refer the the file, REGISTER.DOC, which comes with this package.
  23.  
  24.        TurboCALC is intended to be powerful, yet easy to use.  It supports
  25.        spreadsheets dimensions of 8192 rows by 256 columns, with up to
  26.        16,000 totals cells in use simultaneously.  And supports many math,
  27.        statistical and financial functions.  Hopefully the user can begin
  28.        using the program without reading a lot of documentation, but some
  29.        information is necessary before one can begin.  The program requires
  30.        a minimum of 256k and can use as much as 640k.
  31.  
  32.        For the advanced spreadsheet user, TurboCALC supports up to 500
  33.        range names and virtually unlimited macro capability.
  34.  
  35.        Version 6.00 and later of TurboCALC includes a text editor with
  36.        the program.  You begin by executing the .COM file, then after the
  37.        copyright notice, there will appear a menu from which you can select
  38.        either 1. the calc program, 2. the edit program, or 3. exit to DOS.
  39.        The calc and edit programs are stored as .CHN, .000, .001 and .002
  40.        files.  They must be present for the system to operate.
  41.  
  42.        INSTALLATION
  43.        ────────────
  44.        TurboCALC is overlayed, the .000, .001 and .002 files that came with
  45.        the program are the overlay files.  They must be present in the default
  46.        directory when the program is started, and they may not be removed
  47.        from the system during execution of the program.  You may change
  48.        directories after starting TurboCALC, because TurboCALC will
  49.        automatically find its way back to the original directory for the
  50.        overlays.  This is true for the the config file, .CNF, also.  The
  51.        config file holds the information about your printer & screen setup.
  52.        Also, the .000, .001, .002 and .CHN files must be stored in the same
  53.        directory.
  54.  
  55.        As an alternative to having to all the files in the default directory
  56.        when the program starts, one can place the following code into the
  57.        AUTOEXEC.BAT file and then start TurboCALC from any location:
  58.  
  59.                               PATH=c:\tc
  60.                               set TCPATH=c:\tc
  61.  
  62.        This assumes that drive C is the drive where TurboCALC is stored and
  63.        TC is the directory.  The proper drive and directory should be sub-
  64.        stituted, as appropriate.
  65.  
  66.        DESCRIPTION
  67.        ───────────
  68.        First, let us examine the layout of the worksheet.  On screen,
  69.        there will be displayed 7 columns by 21 rows.  The user may scroll
  70.        both vertically and horizontally.  The vertical scroll is
  71.        accomplished by depressing the PgUp or PgDn keys.  This will
  72.        scroll 20 rows up or down, a single line scroll is achieved by
  73.        moving the cursor off the top or bottom of the screen, with the up
  74.        or down arrow keys.  The horizontal scroll is achieved by depressing
  75.        the Ctrl key and the left or right arrow keys simultaneously.  The
  76.        "scroll lock" may be activated by pressing the "Scroll Lock" key, an
  77.        indicator will show this at the bottom of the screen.  When the
  78.        "scroll lock" is NOT active, the user may scroll right or left by
  79.        moving the cursor off the right or left of the screen.  When
  80.        "scroll lock" is active, the cursor will wrap-around when moved
  81.        off the sides of the screen.
  82.  
  83.        On the top and bottom lines of the screen there appears some status
  84.        information: the current cell, the amount of memory available, the
  85.        auto-calc indicator, the current marked range, the current drive
  86.        and directory, the CAPS, NUM and SCRL lock indicators.  On the second
  87.        line of the screen will appear messages and the numeric or formula
  88.        content of the current cell.
  89.  
  90.        In general, the user may move the cursor to whatever cell he
  91.        desires, and enter the text, number or formula that needs to be in
  92.        that location.  If entering text, it can overwrite cells to the
  93.        right, but may not be longer than 80 characters.
  94.  
  95.        When you begin to enter something into a cell, the first keystroke
  96.        is VERY important.  It will determine the type of item stored in
  97.        the cell: formulas begins with the '(' character,  a number with 0
  98.        thru 9, '+', '-' or '.', and text with any other character.  If you
  99.        desire to enter a text string that begins with a number, 0 thru 9,
  100.        you must prefix it with a single quote character, thusly: '109.
  101.        The quote will show on the screen, but not in the printed report.
  102.        When making the first keystroke of a cell, some keys have different
  103.        meanings, than on succeeding keystrokes.  For example, the left and
  104.        right arrow keys will move the cursor around the worksheet, but during
  105.        the entry of data into a cell, these keys will act to move the cursor
  106.        within the cell, to edit the data.  Other keys that behave differently,
  107.        are the Home, End and "/" keys.  The Home and End keys move the cursor
  108.        to the beginning or the end of the worksheet, but during the entry of
  109.        data, they move to the beginning or end of the current cell.  Also
  110.        during data entry, the Esc key will act to finish the entry and move to
  111.        the cell below, so that a column of numbers may be entered with the Num
  112.        Lock turned on.
  113.  
  114.        If you depress the "/" key, at the start of a cell, a list of
  115.        commands will appear, any of the displayed commands may be
  116.        executed by pressing the indicated letter.  For experienced users,
  117.        the commands may be entered directly, without using the "/" key,
  118.        by pressing the Alt key and the command letter together.
  119.  
  120.        Following are two lists.  The first is a list the the cursor
  121.        control and editing keys.  The second is a list of the command
  122.        letters.
  123.  
  124.  
  125.                               Action                  Action
  126.        Key Name          During Data Entry           Otherwise
  127.        ────────────────╥──────────────────────╥─────────────────────
  128.        /               ║ Put a "/" in literal ║ Display the menu of
  129.                        ║ data in cell.        ║ commands.
  130.        ────────────────╫──────────────────────╫─────────────────────
  131.        \               ║ Put a "\" in literal ║ Display the macro keys
  132.                        ║ date in cell.        ║ for entry or change.
  133.        ────────────────╫──────────────────────╫─────────────────────
  134.        F1              ║ Produces the help    ║ Produces the help
  135.                        ║ screens.             ║ screens.
  136.        ────────────────╫──────────────────────╫─────────────────────
  137.        F2              ║ No action.           ║ Enter edit mode on
  138.                        ║                      ║ current cell.
  139.        ────────────────╫──────────────────────╫─────────────────────
  140.        F3              ║ Switch to the text   ║ Switch to the text
  141.                        ║ edit module.         ║ edit module.
  142.        ────────────────╫──────────────────────╫─────────────────────
  143.        F4              ║ Enter/edit/list the  ║ Enter/edit/list the
  144.                        ║ range names.         ║ range names.
  145.        ────────────────╫──────────────────────╫─────────────────────
  146.        F5              ║ Repeat the previous  ║ Repeat the previous
  147.                        ║ locate command, see  ║ locate command, see
  148.                        ║ the Alt-J command.   ║ the Alt-J command.
  149.        ────────────────╫──────────────────────╫─────────────────────
  150.        Up Arrow        ║ Finish entry and     ║ Move to cell above.
  151.                        ║ move to cell above.  ║
  152.        ────────────────╫──────────────────────╫─────────────────────
  153.        Down Arrow      ║ Finish entry and     ║ Move to cell below.
  154.                        ║ move to cell below.  ║
  155.        ────────────────╫──────────────────────╫─────────────────────
  156.        Left Arrow      ║ Move 1 character to  ║ Move to cell on the
  157.                        ║ the left.            ║ left
  158.        ────────────────╫──────────────────────╫─────────────────────
  159.        Right Arrow     ║ Move 1 character to  ║ Move to cell on the
  160.                        ║ the right.           ║ right.
  161.        ────────────────╫──────────────────────╫─────────────────────
  162.        PgUp            ║ Finish entry and     ║ Move up 1 screen.
  163.                        ║ move up 1 screen.    ║
  164.        ────────────────╫──────────────────────╫─────────────────────
  165.        PgDn            ║ Finish entry and     ║ Move down 1 screen.
  166.                        ║ move down 1 screen.  ║
  167.        ────────────────╫──────────────────────╫─────────────────────
  168.        Home            ║ Move to the start of ║ Move to cell at the
  169.                        ║ the cell.            ║ start of worksheet.
  170.        ────────────────╫──────────────────────╫─────────────────────
  171.        End             ║ Move to the end of   ║ Move to cell at the
  172.                        ║ the cell.            ║ end of worksheet.
  173.        ────────────────╫──────────────────────╫─────────────────────
  174.        Ctrl + End      ║ Erase contents of    ║ Erase current cell
  175.                        ║ cell from cursor to  ║ entirely.
  176.                        ║ end of cell.         ║
  177.        ────────────────╫──────────────────────╫─────────────────────
  178.        Ctrl + L. Arrow ║ Finish entry and     ║ Scroll to the left.
  179.                        ║ scroll to the left.  ║
  180.        ────────────────╫──────────────────────╫─────────────────────
  181.        Ctrl + R. Arrow ║ Finish entry and     ║ Scroll to the right.
  182.                        ║ scroll to the right. ║
  183.        ────────────────╫──────────────────────╫─────────────────────
  184.        Ctrl + PgUp     ║ Finish entry and go  ║ Go to top of the
  185.                        ║ to top of worksheet. ║ worksheet.
  186.        ────────────────╫──────────────────────╫─────────────────────
  187.        Ctrl + PgDn     ║ Finish entry and go  ║ Go to end of the
  188.                        ║ to end of worksheet. ║ worksheet.
  189.        ────────────────╫──────────────────────╫─────────────────────
  190.        Tab             ║ Finish entry and     ║ Move to cell on the
  191.                        ║ move to cell right.  ║ right.
  192.        ────────────────╫──────────────────────╫─────────────────────
  193.        Shift + Tab     ║ Finish entry and     ║ Move to cell on the
  194.                        ║ move to cell left.   ║ left.
  195.        ────────────────╫──────────────────────╫─────────────────────
  196.        Ins             ║ Toggle Insert Mode.  ║ Toggle Insert Mode.
  197.                        ║ Fat cursor = Insert. ║ Fat cursor = Insert.
  198.        ────────────────╫──────────────────────╫─────────────────────
  199.        Del             ║ Delete character at  ║ Delete cursor at
  200.                        ║ cursor.              ║ cursor.
  201.        ────────────────╫──────────────────────╫─────────────────────
  202.        Backspace       ║ Delete character to  ║ No action.
  203.                        ║ left of cursor.      ║
  204.        ────────────────╫──────────────────────╫─────────────────────
  205.        Enter           ║ Finish entry.  Stay  ║ No action.
  206.                        ║ in current cell.     ║
  207.        ────────────────╫──────────────────────╫─────────────────────
  208.        Esc             ║ Finish entry and     ║ Move cursor to the
  209.                        ║ move to cell below.  ║ cell below.
  210.                        ║ Nice for using NUM   ║
  211.                        ║ Lock mode with a     ║
  212.                        ║ column of numbers!   ║
  213.        ────────────────╨──────────────────────╨─────────────────────
  214.  
  215.  
  216.  
  217.        Command Table: With Alt key, or preceded by the "/" key.
  218.                       The "/" key brings up the command list.
  219.        ─────────────────────────────────────────────────────────────
  220.        Q         Exit to DOS.
  221.        ─────────────────────────────────────────────────────────────
  222.        Space     Remove command list and return to worksheet.
  223.        ─────────────────────────────────────────────────────────────
  224.        L         Produce a directory list.
  225.        ─────────────────────────────────────────────────────────────
  226.        N         Change to new directory and/or disk drive.
  227.        ─────────────────────────────────────────────────────────────
  228.        R         Read worksheet from disk into memory.  There are
  229.                  two options offered when ALT-R is selected: 1) to
  230.                  clear memory before reading or 2) to merge the file
  231.                  into memory.  The first option, to clear memory, is
  232.                  the more usual, especially for people who have
  233.                  separate worksheets.  The "merge" option is very
  234.                  handy for people who want to combine together smaller
  235.                  worksheets, the merge will bring in the file at the
  236.                  current cursor location.  Any formulas in the merged
  237.                  file will be adjusted if they do not use absolute
  238.                  addressing.
  239.        ─────────────────────────────────────────────────────────────
  240.        S         Store worksheet from memory onto disk.
  241.  
  242.                  Both the R and S commands assume the .SSF extension
  243.                  if the user doesn't specify one.  If no extension
  244.                  is desired end the filename with a '.' and no ext-
  245.                  ension will be used.
  246.        ─────────────────────────────────────────────────────────────
  247.        E         Erase part or all of the current worksheet from
  248.                  memory.  If you elect to erase only a part of the
  249.                  worksheet, you can set the range to be erased before
  250.                  the erasure begins.  For example: press Alt-E to begin,
  251.                  then press R and set the desired range, after the
  252.                  range has been set press P to erase the selected range.
  253.                  Menus are provided by the program to lead you thru
  254.                  this procedure.  If you select P prior to setting a
  255.                  range, only the current cell will be erased.
  256.        ─────────────────────────────────────────────────────────────
  257.        G         Perform the calculations specified by user
  258.                  formula.  Note: the worksheet is not automatically
  259.                  recalculated after one inserts/deletes a row or
  260.                  column, one should use the G command to do this.
  261.        ─────────────────────────────────────────────────────────────
  262.        P         Print the worksheet to disk file or printer.
  263.                  If you encounter difficulty printing directly to
  264.                  the printer, one may print to a file and then
  265.                  COPY the file to the printer from the DOS prompt.
  266.                  For example, if the filename chosen to hold the
  267.                  printout was "foobar", then one would enter the
  268.                  following command from the DOS prompt:
  269.  
  270.                               COPY foobar prn:
  271.  
  272.        ─────────────────────────────────────────────────────────────
  273.        V         View a graph.  This command will display a bar
  274.                  graph of the selected range, with the selected
  275.                  labels.  The data range should not be more than
  276.                  6 lines deep, this is the maximum.  However, the
  277.                  program will display widths that range up to 70 or
  278.                  more columns, depending on how many lines are
  279.                  selected.  Refer to the GRAPH.SSF file for an
  280.                  example.  It is possible to ask for more than the
  281.                  maximum lines or columns, TC will simply truncate
  282.                  the request to fit.  After the graph has been viewed
  283.                  the program will ask if you wish to save the graph
  284.                  to disk.  This file is suitable for printing or further
  285.                  modification using a text editor.
  286.        ─────────────────────────────────────────────────────────────
  287.        F         Change cell format.  Each cell may have a
  288.                  different format.  The default is leading sign, no
  289.                  comma and no currency symbol.  You may choose 1 of
  290.                  6 different formats: financial, percent, scientific,
  291.                  hidden, date, and the default.  If the date format is
  292.                  chosen, the cell is treated as if it contained a Julian
  293.                  date and then it is converted to one of three sub-formats:
  294.                  DD-MMM-YY, DD-MMM or MMM-YY.  You will be given you choice
  295.                  of these 3 date formats, if you select the date type.
  296.                  If the financial format is chosen, you will be given the
  297.                  choice of 4 sub-formats:
  298.                     A.  $1,000- .... Dollar sign and comma insertion.
  299.                     B.   1,000- .... Comma insertion.
  300.                     C.  (1,000) .... Dollar sign and comma insertion,
  301.                                      parens for negative.
  302.                     D. $(1,000) .... Comma insertion, parens for negative.
  303.        ─────────────────────────────────────────────────────────────
  304.        W         The width of each column defaults to 10, but it can
  305.                  be changed with this command to any value between
  306.                  0 and 30.  After setting the width, the user is asked
  307.                  if the column should be given the "blank zero" attribute.
  308.  
  309.                  Note: If a column width of 0 is chosen, then this has
  310.                  the same effect as if the whole column had the "hidden"
  311.                  format.  Anything in a 0 width column or with the
  312.                  "hidden" format, will appear on the status line at
  313.                  the top of the screen, but will not appear in the
  314.                  worksheet.
  315.        ─────────────────────────────────────────────────────────────
  316.        B         Mark the start of the range at the current cell.
  317.        ─────────────────────────────────────────────────────────────
  318.        K         Mark the end of the range at the current cell.
  319.        ─────────────────────────────────────────────────────────────
  320.        H         The user may specify that columns are to be held
  321.                  on the left of the screen and not horizontally
  322.                  scrolled.  4 columns maximum.
  323.  
  324.                  The user may also specify that rows are to be held
  325.                  on the top of the screen and not vertically scrolled.
  326.                  10 rows maximum.
  327.        ─────────────────────────────────────────────────────────────
  328.        I         Insert Row or Column.  Formula will be adjusted
  329.                  to reflect their new locations.  Absolute addresses
  330.                  may be used, by placing a '0' before the row.  For
  331.                  example 'C5' is a relative cell address and would
  332.                  be adjusted if needed, but 'C05' is an absolute
  333.                  cell address and would not be adjusted.   Recalculation
  334.                  does not automatically take place after execution
  335.                  of this command.
  336.        ─────────────────────────────────────────────────────────────
  337.        D         Delete Row or Column.  Formula will be adjusted
  338.                  as given above for 'I'.  If the range option is
  339.                  selected, then the rows or columns that fall within
  340.                  the specified range will be deleted.  Note: only
  341.                  rows or columns are deleted, not both at the same
  342.                  time.  Recalculation does not automatically take
  343.                  place after execution of this command.
  344.        ─────────────────────────────────────────────────────────────
  345.        J         Jump directly to a cell.  Avoid scrolling when you
  346.                  know where to go.  You may also go to a cell based
  347.                  on its content, select the L option of this commands
  348.                  menu and enter the value you want to locate.  The
  349.                  locate for the same value can be repeated automantically
  350.                  by pressing F5 when you wish to find the next item.
  351.        ─────────────────────────────────────────────────────────────
  352.        M         Move the indicated range to the current location.
  353.                  The user is given the opportunity to alter the
  354.                  range specification.  Formula are adjusted as
  355.                  above for 'I'.  This command senses overlaping
  356.                  ranges, and will adjust so that an ascending or
  357.                  descending move is done whenever needed.
  358.        ─────────────────────────────────────────────────────────────
  359.        C         Copy the indicated range to the current location.
  360.                  The user is given the opportunity to alter the
  361.                  range specification.  Formula are adjusted as
  362.                  above for 'I'.
  363.        ─────────────────────────────────────────────────────────────
  364.        O         Sort the indicated range into ascending order.  The
  365.                  sort key is the first column of the range and the
  366.                  rows within the range are arranged into ascending
  367.                  sequence based on the textual content of the key
  368.                  column (the first one in the indicated range).
  369.                  Note: only cells actually within the range are
  370.                  sorted, so the exact dimensions of the table
  371.                  that needs sorting should be given.
  372.        ─────────────────────────────────────────────────────────────
  373.        A         Toggle auto-calculate.  If many formulas are in the
  374.                  worksheet, it may save time to turn auto-calculate
  375.                  off, and manually calculate with the 'G' command.
  376.        ─────────────────────────────────────────────────────────────
  377.        Y         Import a file.  You may import either a fixed column
  378.                  format, standard ASCII text file or a DIF file.  DIF(tm)
  379.                  stands for Data Interchange Format and is commonly supported
  380.                  by many programs including 1-2-3(tm).  The DIF(tm)
  381.                  supports only the storage of the data, so the format
  382.                  control information and the formulas are not found
  383.                  in the in the DIF(tm) file.
  384.  
  385.                  If you select the text file import, the file will
  386.                  be read into the column where the cursor is located.
  387.                  Each line of the file will cause the import to go
  388.                  to the next row of the worksheet.
  389.  
  390.                  If you select the fixed column format, you must set
  391.                  the column widths, via the Alt-W command, to be equal
  392.                  to the width of the columns in the file to be imported.
  393.                  For example, let's say that the import file has 3 columns,
  394.                  the first column contains a label 30 characters wide, the
  395.                  second and third columns contain numbers, each being 12
  396.                  characters in width.  Then you should set your column
  397.                  widths to these values: 30 for column A, 12 for columns
  398.                  B & C.  After the widths are properly set the import
  399.                  may be done.  Remeber to position the cursor to the
  400.                  first cell to be filled, as for text imports!
  401.        ─────────────────────────────────────────────────────────────
  402.        Z         Export a DIF(tm) format file.  Please read the above
  403.                  paragraph about for the "Y" command.  The output file
  404.                  will contain data only, no formulas or format control
  405.                  information.  Also, the DIF(tm) format is not as
  406.                  efficient as the TurboCALC .SSF format, so the exported
  407.                  file will probably be about 10% to 300% larger than
  408.                  the original file.
  409.  
  410.                  Note: if you wish to export an ASCII text file, use
  411.                  the printout feature, ALT-P, which can be redirected
  412.                  to a file instead of the printer.
  413.        ─────────────────────────────────────────────────────────────
  414.        U         The user may control the screen colors via this
  415.                  command.  The colors are entered as numbers from
  416.                  the following list:
  417.  
  418.                      0 : Black             8 : Dark Gray
  419.                      1 : Blue              9 : Light Blue
  420.                      2 : Green            10 : Light Green
  421.                      3 : Cyan             11 : Light Cyan
  422.                      4 : Red              12 : Light Red
  423.                      5 : Magenta          13 : Light Magenta
  424.                      6 : Brown            14 : Yellow
  425.                      7 : Light Gray       15 : White
  426.  
  427.        ─────────────────────────────────────────────────────────────
  428.        T         This command acts as a toggle switch, it controls
  429.                  whether or not the current cell is protected.
  430.                  If a cell is protected, when the cursor moves
  431.                  to the cell, it appears in the same colors as a window
  432.                  frame, otherwise cells have normal cursor highlighting.
  433.                  One may not enter information into a protected cell,
  434.                  unless the protection is released.  This is a safeguard
  435.                  feature, to keep data from being accidentally
  436.                  destroyed.
  437.        ─────────────────────────────────────────────────────────────
  438.        Note: DIF is a trademark of Software Arts Products Corp.
  439.              1-2-3 is a trademark of Lotus Development Corp.
  440.  
  441.  
  442. Now some discussion about selected topics:
  443.  
  444. 1. Formulas.
  445.  
  446.    Formulas are composed of operational symbols, cell addresses,
  447.    constants, and functions.  Each formula is enclosed within
  448.    parenthesis, like this: (A1+C2+F4).  This formula would take
  449.    the content of the 3 cells and add them together, depositing
  450.    the result in the cell where the formula is located.
  451.  
  452.    The following functions are available:
  453.  
  454.    Name      Description                             Usage
  455.    ────      ───────────                             ────────
  456.    ABS       Absolute value.                         ABS(p)
  457.    SQRT      Square root.                            SQRT(p)
  458.    SQR       Square.                                 SQR(p)
  459.    MOD       The remainder of p1 divided by p2.      MOD(p1,p2)
  460.    INT       Returns the integer portion of p.       INT(p)
  461.    ROUND     Rounds p to the n'th precision.         ROUND(p,n)
  462.              Where n is the number of digits after
  463.              the . of accuracy wanted.  For example:
  464.              ROUND(100.256,2) would produce 100.26 as
  465.              the result.
  466.  
  467.    PI        3.1415926536                            PI
  468.    SIN       Sine of angle in radians.               SIN(p)
  469.    ASIN      Arc sine.                               ASIN(p)
  470.    COS       Cosine of angle in radians.             COS(p)
  471.    ACOS      Arc cosine.                             ACOS(p)
  472.    TAN       Tangent of angle in radians.            TAN(p)
  473.    ATAN      Arc Tangent.                            ATAN(p)
  474.  
  475.    LN        Natural Log.                            LN(p)
  476.    LOG       Log base 10.                            LOG(p)
  477.    E         2.7182818285                            E
  478.    EXP       E raised to the p power.                EXP(p)
  479.  
  480.    NPV       Net present value of a series           NPV(i,r)
  481.                of future cash flows.
  482.    PMT       Mortgage payment per period.            PMT(pa,i,n)
  483.    PV        Present value of ordinary annuity.      PV(pp,i,n)
  484.    FV        Future value of ordinary annuity.       FV(pp,i,n)
  485.    RATE      Periodic rate needed to produce         RATE(fv,pv,n)
  486.                a future value.
  487.    TERM      The number of payment periods required  TERM(pp,i,fv)
  488.                for an annuity to grow to a future
  489.                value.
  490.    CTERM     The number of compounding periods       CTERM(i,fv,pv)
  491.                required for a present value to
  492.                future value.
  493.    IRR       Internal Rate of Return.                IRR(g,r)
  494.  
  495.    AVG       The average.                            AVG(r)
  496.    SUM       The sum of all item in range.           SUM(r)
  497.    COUNT     The number of items in range.           COUNT(r)
  498.    MIN       The smallest number in range.           MIN(r)
  499.    MAX       The biggest number in range.            MAX(r)
  500.    VAR       The population variance.                VAR(r)
  501.    STD       The population standard deviation.      STD(r)
  502.  
  503.    SYD       The depreciation for the specified      SYD(cst,sal,lif,per)
  504.                period, using the "Sum Of The Years
  505.                Digits" method.
  506.    SLN       The "Straight line" depreciation for    SLN(cst,sal,lif)
  507.                1 period.
  508.    DDB       The depreciation for the specified      DDB(cst,sal,lif,per)
  509.                period, using the "Double Declining
  510.                Balance" method.
  511.  
  512.    IF        Choose between two values.              IF(t,p1,p2)
  513.                p1 is returned if t is true,
  514.                p2 is returned if t is false.
  515.    NOT       Reverse true and false values.          NOT(t)
  516.    TRUE      Returns the value for true.             TRUE
  517.    FALSE     Returns the value for false.            FALSE
  518.    ERR       Returns the value for ERR.              ERR
  519.    ISERR     Returns the value for true if the       ISERR(p)
  520.                parameter has the ERR value,
  521.                otherwise returns the value for
  522.                false.
  523.    NA        Returns the value for NA.               NA
  524.    ISNA      Returns the value for true if the       ISNA(p)
  525.                parameter has the NA value,
  526.                otherwise returns the value for
  527.                false.
  528.  
  529.    DATE      Returns the Julian date from the        DATE(y,m,d)
  530.                calendar date given as a parameter.
  531.                The year maybe between 1800 and
  532.                2100 and the date is measured in
  533.                days from December 31, 1899.
  534.    TODAY     Returns the Julian date for today.      TODAY
  535.                Taken from the DOS clock, so if
  536.                you have set it wrong, then this
  537.                will be wrong.
  538.    DAY       Returns the day of the month,           DAY(p)
  539.                given the Julian date.
  540.    MONTH     Returns the month of the year,          MONTH(p)
  541.                given the Julian date.
  542.    YEAR      Returns the year, given the             YEAR(p)
  543.                Julian date.
  544.  
  545.    HLOOKUP   Table lookups find the largest table    HLOOKUP(trgt,tbl,ofs)
  546.                entry not greater than the target
  547.                value.  The "HLOOKUP" function
  548.                defines a horizontal table.
  549.    VLOOKUP   The "VLOOKUP" function defines a        VLOOKUP(trgt,tbl,ofs)
  550.                vertical table.
  551.  
  552.    Note: There are many examples in the sample spreadsheet that
  553.          accompanies the program.
  554.  
  555.    Where:  p,p1,p2 ... Constants, cell addresses or algebraic
  556.                          expressions.
  557.            i ......... Interest rate, may be any of the items
  558.                          listed for "p" above.  Note: all
  559.                          interest rates are stated in their
  560.                          fractional format, i.e. "10% = 0.1".
  561.                          Note: this is an interest rate per period
  562.                          and not per annum, however if the period
  563.                          in use is a year, then it is per annum.
  564.                          If a month is the period in use, then
  565.                          conversion from the yearly rate must
  566.                          be done by division by 12.
  567.            r ......... A range of cell addresses, i.e. "D4..H21".
  568.            pa ........ Principle amount, may be any of the items
  569.                          listed for "p" above.
  570.            n ......... Number of periods, may be any of the
  571.                          items listed for "p" above.
  572.            pp ........ Payment per period, may be any of the
  573.                          items listed for "p" above.
  574.            g ......... A guess at the interest rate, usually
  575.                          between 0.0 and 1.0.
  576.            pv ........ A present value, may be any of the items
  577.                          listed for "p" above.
  578.            fv ........ A future value, may be any of the items
  579.                          listed for "p" above.
  580.            t ......... A logical expression whose result is
  581.                          0.0 for false and non-zero for true.
  582.            y,m,d ..... May be any value listed for "p" above.
  583.                          They are the symbols for year, month and day.
  584.            trgt ...... May be any value listed for "p" above.  It is
  585.                          the value which is the target of the lookup.
  586.            tbl ....... A range of cell addresses that define the values
  587.                          to be searched to find the match for the target
  588.                          in a lookup.
  589.            ofs ....... May be any value listed for "p" above.  It is
  590.                          the value added to the matching entry's coordinates
  591.                          to find the answer in a lookup table.  Usually is
  592.                          a 1.
  593.            cst ....... The cost of an asset.
  594.            sal ....... The salvage value of an asset.
  595.            lif ....... The life expectancy of an asset.
  596.            per ....... The period for which depreciation is to be
  597.                          calculated.
  598.  
  599.    Formulas may be quite complicated, an example is:
  600.  
  601.                   (A1+SIN(PI/2*(B2-C1)))
  602.  
  603.    The only limitations imposed are those of available memory and
  604.    the fact that no formula may be longer than 80 characters.
  605.    The financial and trig function are not recusive, for example
  606.    don't do this: (IRR(IRR(.2,D4..D20),E2..M2)), it won't work
  607.    very well, if at all.  If any of the formulas cannot calculate
  608.    the answer, for example if you ask for the SQRT of a negative
  609.    number, then the result will be ERROR and you will see the word
  610.    "ERR" in the result cell.
  611.  
  612.    Finally, a formula may contain the following symbols:
  613.  
  614.                 ^      Raise to the power.
  615.                 *      Multiplication
  616.                 /      Division
  617.                 +      Addition
  618.                 -      Subtraction
  619.                 :      Range summation, same as SUM function,
  620.                             i.e. (SUM(A1..B5)) is the same as (A1:B5)
  621.                 |      Logical OR
  622.                 &      Logical AND
  623.                 >      Greater than test
  624.                 <      Less than test
  625.                 =      Equal test
  626.                 >=     Greater than or equal test
  627.                 <=     Less than or equal test
  628.  
  629.    These are probably familiar, with the exception of the ":" for
  630.    range summation.  Let's say that you want to sum a column of
  631.    numbers, beginning at D1 and ending at D20, then this
  632.    expression would sum the column, (D1:D20).
  633.  
  634. 2. Overwritten cells.
  635.  
  636.    TurboCALC will allow you to make text entries of any length up
  637.    to a maximum of 80 characters, numeric entries may be up to 11
  638.    characters.  Any text entry that exceeeds the cell width will
  639.    automatically lock the adjacent cell on the right.  The lock will
  640.    be relased when the length of the entry shrinks.
  641.  
  642. 3. The Range and the commands that use it.
  643.  
  644.    The range is shown on the bottom left of the worksheet screen.
  645.    It is of the form: cell address..cell address.  If you have not
  646.    set the range, it defaults to the beginning and ending cell of
  647.    the worksheet.  There are two methods of setting the range:
  648.    1st, you can make the beginning and ending cells with the B and
  649.    K commands, 2nd, whenever one of the commands that use the
  650.    range is invoked, you have the opportunity of changing the
  651.    range by entering the new range.  For example the Copy command
  652.    will give you a menu with 3 options: Range, Copy and eXit.  If
  653.    you select the Range option, you will be allowed to enter a new
  654.    range, in the same format as displayed at the bottom of the
  655.    screen.  Here are the commands affected by the range: Copy,
  656.    Move and Print.
  657.  
  658. 4. Printer Setup.
  659.  
  660.    If you select the Print command, one of the options presented
  661.    on the Print menu is "Setup".  If you select the Setup option
  662.    you will be able to control the margins and dimensions of the
  663.    printed report.  Also, you will be given the option called
  664.    Control.  The Control option allows you to specify printer
  665.    setup control codes and printer exit control codes.  These
  666.    control codes default to Form Feed characters, but you may
  667.    specify whatever necessary.  The convention for specifying
  668.    these codes is to use the decimal numbers representing the
  669.    control codes separated by commas.  You can also put plain text
  670.    in the control strings, if you surround the text with "
  671.    marks.  For example: "This is a control string",12,12
  672.    If this was the setup control string, when the print began the
  673.    program would send the following to the printer: 'This is a
  674.    control string' FF FF.  Of course, the quotes would not be
  675.    sent, and the FF is just a symbolic way to represent the form
  676.    feed character.  With this method, you may program your printer
  677.    in whatever way you wish.
  678.  
  679.    There are 2 dot commands for the printer.  If you put .PAGE in
  680.    column A of any row, it will cause a page break to occur at
  681.    that place.  The remainder of the row with the dot command
  682.    will not print.  After you have entered .PAUSE in column A of
  683.    a row, page breaks will cause a pause for you to insert the
  684.    next page and give you an option to reprint a page or exit
  685.    the print function.
  686.  
  687. 5. Internal Rate of Return.
  688.  
  689.    This function provides an iterative approximation for the
  690.    interest rate which will produce a zero for the Net Present
  691.    Value function.  The range for this function should include
  692.    present cash flows as well as future cash flows.  The approach
  693.    to finding the zero is as follows, 14 loops thru the
  694.    "Bisection Method", followed by up to 6 loops thru the
  695.    "Modified-False Position Method".  Usually the IRR function
  696.    will converge to within 0.000001.  In some instances, where
  697.    the cash flows turn negative in a later period, there are
  698.    multiple solutions, however IRR finds the closest one only.
  699.    Your guess input to this function should be between 0.0 and 1.0.
  700.    In some cases, the function will not converge, either the
  701.    solution is too small or too large, in these cases the function
  702.    will return ERR.  Try adjusting you guess and recalculate.
  703.  
  704. 6. Range names.  Range names may be up to 15 characters long.  They
  705.    may contain any alpha or numeric character.  They should not contain
  706.    any blank or punctuation characters.  Up to 500 ranges may be named
  707.    in each worksheet.  When referenced, the range name must be preceded
  708.    with a @ character.  This signals TC that a range name is being used.
  709.    Range names may be used anyplace a range or cell address is called for.
  710.    The F4 key is used to bring up the range names for editing or examination.
  711.  
  712. 7. The macro keys are the 10 function keys used in combination with Alt, Ctrl
  713.    and Shift.  These values in the macro keys are stored in the .CNF file and
  714.    are thus independent of the worksheet.  However, macros may be stored in
  715.    the worksheet, at any cell location, and referred to via a JUMP command
  716.    from the normal macro keys.  Thus macros may be quite long and complex.
  717.  
  718.    NOTE: cell addresses are not automatically relocated when they are
  719.          embedded in macros, so it is advisable to use the range name
  720.          feature in conjunction with macros - range names are automatically
  721.          relocated as required.
  722.  
  723.    Macros are simply a device to record keystrokes for playback at a later
  724.    time.  So if you have repetitive processes or processes that you are
  725.    setting up for others to use, then macros are very handy indeed.
  726.  
  727.    Since some of the keys on the keyboard cannot be easily recorded in a
  728.    macro, they have a special name assigned.  When using these special
  729.    names, enclose the name within {}.  For example: {END} is the way to
  730.    indicate the pressing of the End key.  Here is the list of special names:
  731.  
  732.       Name            Description
  733.       ----            -----------
  734.       UP              Up Arrow key.
  735.       DOWN            Down Arrow key.
  736.       LEFT            Left Arrow key.
  737.       RIGHT           Right Arrow key.
  738.       HOME            Home key.
  739.       END             End key.
  740.       PGUP            PgUp key.
  741.       PGDN            PgDn key.
  742.       INS             Ins key.
  743.       DEL             Del key.
  744.       BS              Back Space key.
  745.       ESC             Esc key.
  746.       TAB             Tab key.
  747.       BTAB            Backward Tab key.
  748.       ^END            Ctrl-End key combo.
  749.       EDIT            F2, means to edit current cell.
  750.       RANGE           F4, means to enter/edit/list range names.
  751.  
  752.    It is also possible to use a Carriage Return in a macro by using the
  753.    ~, tilde, character wherever a Carriage Return is required.  Also, it
  754.    is IMPORTANT to note, that when writing a macro in normal cell locations
  755.    it is often desirable to begin a line with either the / or \ characters.
  756.    This is not possible, because TurboCALC will think that you mean to
  757.    execute an immediate command.  To allow you to do this, place the ~, tilde,
  758.    before the / or \ character, this will cause TurboCALC to allow the
  759.    entry to be made.
  760.  
  761.    For example:
  762.  
  763.        /JCA1~        Will not work if stored in a normal worksheet cell
  764.                      because TurboCALC will execute the command immediately.
  765.  
  766.    Instead enter:
  767.  
  768.        ~/JCA1~       The initial ~ is a throw-away, but it allows you to enter
  769.                      the command for later execution.
  770.  
  771.    There are some special / commands that appear only in macros:
  772.  
  773.        /Q            Quit the worksheet module.
  774.  
  775.        /XGca~        Transfer execution of the macro to the cell address "ca".
  776.  
  777.        /XCca~        Call a subroutine macro at the cell address "ca".
  778.  
  779.        /XR           Return from subroutine to the calling macro.  Execution
  780.                      pickups at the next instruction following the /XC in the
  781.                      calling macro.
  782.  
  783.        /XQ           Quit the macro and return to manual worksheet operation.
  784.  
  785.        /XNps~ca~     Input a numeric value and store at the cell address "ca".
  786.                      The string "ps" is used to prompt for input.
  787.  
  788.        /XLps~ca~     Input a literal value and store at the cell address "ca".
  789.                      The string "ps" is used to prompt for input.
  790.  
  791.        /XIcond~      Tests the condition and branch accordingly.  The "cond"
  792.                      contains some expression that is tested to be true.  If
  793.                      it is not found to be true, then execution of the macro
  794.                      continues with the next line of the macro, if it is true
  795.                      then the current line continues execution.  For example:
  796.  
  797.                         /XIb2>100~/XGg30~
  798.  
  799.                         If the contents of cell B2 is greater than 100 the
  800.                         macro will transfer execution to cell G30, otherwise
  801.                         it will continue execution with the next line following
  802.                         the /XI command.
  803.  
  804.  
  805.        /XMca~        Execute a menu stored at the cell address "ca".
  806.                      Here is a sample of a menu stored at cell address B2.
  807.                      The command words are stored in the first line, B2..D2,
  808.                      the command descriptions are in the next line, B3..D3,
  809.                      the macro commands which are executed when the user
  810.                      selects an option are stored immediately below the
  811.                      related option.  Each macro may be any number of lines
  812.                      long and is terminated with an empty cell.  The same
  813.                      is true for the width of the menu, it terminates when
  814.                      an empty column is found.
  815.  
  816.                  A               B               C               D
  817.            1
  818.            2                   Yes             No              Maybe
  819.            3                   First Choice    Second Choice   Third Choice
  820.            4                   No. 1~          No. 2~          No. 3~
  821.            5                                   ~/Q
  822.  
  823.  
  824. The Editor
  825. ──────────
  826.    Starting with version 6.00 of TurboCALC, an editor is included
  827.    with the package.  This editor is largely the result of the
  828.    "Turbo EDITOR TOOLBOX"(tm).  The editor has been customized and
  829.    integrated with TurboCALC, and it is planned that more customization
  830.    and intergration will occur in the future.  At this time,
  831.    the editor has quite a list of features, including the ability to
  832.    print in background while editing a 2nd file, and windows can open
  833.    so that 2 files may be edited/viewed side-by-side.  If you would
  834.    like to be able to customize your own editor, I suggest you purchase
  835.    the toolbox from Borland International Inc.  It is quite excellent and
  836.    there are no royalties!
  837.  
  838.  
  839.    Command List
  840.    ────────────
  841.      ^A       Left Word                   Larrow  To left on line
  842.      ^S       Left Character              Rarrow  To right on line
  843.      ^D       Right Character             ^Q^J    Jump to marker
  844.      ^F       Right Word                  ^Q^I    Toggle auto indent mode
  845.      Uarrow   Up Line                     ^Q^R    To top of File
  846.      Darrow   Down Line                   ^Q^C    To end of File
  847.      PgUp     Up Page                     ^Q^B    To begin of Block
  848.      PgDn     Down Page                   ^Q^K    To end of Block
  849.      ^W       Scroll Up                   ^Q 1    Jump to Marker 1
  850.      ^Z       Scroll Down                 ^Q 2    Jump to Marker 2
  851.      RETURN   New Line                    ....    ....
  852.      ^N       Insert Line                 ^Q 9    Jump to Marker 9
  853.      ^G,DEL   Delete Character            ^Q^Y    Delete Line Right
  854.      BKSP     Delete Left Character       ^Q^F    Find Pattern
  855.      ^I       Tab                         ^Q^A    Find and Replace
  856.      ^T       Delete Word
  857.      ^Y       Delete Line                 ^K^S    Save File & Resume
  858.      ^B       Reformat Paragraph          ^K^D    Save & open new file
  859.      Ins      Toggle Insert Mode          ^K^X    Save & exit to Menu
  860.      ^L       Find Next Occurrence        ^K^Q    Abandon & open new file
  861.      ^J       Beginning/End of line       ^K 1    Set Marker 1
  862.      Home     Move to beginning of line   ^K 2    Set Marker 2
  863.      End      Move to end of line          ...    ....
  864.      ^P       Insert Char by ASCII        ^K 9    Set Marker 9
  865.      ^O^O     Open new window
  866.      ^O^L     Set Left Margin             ^K^B    Begin Block
  867.      ^O^R     Set Right Margin            ^K^K    End Block
  868.      ^O^C     Center Line                 ^K^H    Hide Block
  869.      ^O^K     Change Case                 ^K^C    Copy Block
  870.      ^O^S     Set UNDO Limit              ^K^V    Move Block
  871.      ^O^W     Toggle Wordwrap Mode        ^K^Y    Delete Block
  872.      ^O^G     Goto other window           ^K^W    Write Block
  873.      ^O^I     Goto Column                 ^K^R    Read block
  874.      ^O^N     Goto Line                   ^K^M    Set marker
  875.      ^O^Y     Destroy window              ^K^T    Define tab width
  876.      F2       Switch to the CALC module    F10    Activate Pulldown Menus
  877.      ESC      Undo last change
  878.  
  879.    Note: Turbo EDITOR TOOLBOX is a trademark of Borland International Inc.
  880.  
  881.    Some useful options:
  882.  
  883.        With ^Q^F:  U  - For search that is case independent.
  884.  
  885.        With ^Q^A:  U  - As above for ^Q^F.
  886.                    G  - Global search.
  887.                    N  - Replace without asking.
  888.  
  889.    A hint:
  890.  
  891.        When using the ^P command to insert printer codes into the
  892.        text, you press ^P followed by the control character you want
  893.        to send to the printer.  You can enter only 1 control character
  894.        each time you press ^P.
  895.  
  896.